System.Array.Resize 方法

方法描述

将数组的元素数更改为指定的新大小。

语法定义(C# System.Array.Resize 方法 的用法)

public static void Resize(
	ref T[] array,
	int newSize
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
array T[]% 要调整大小的一维数组，该数组从零开始；如果为 null 则新建具有指定大小的数组。
newSize System-Int32 新数组的大小。
返回值 void

提示和注释

此方法分配一个具有指定大小的新数组，将元素从旧数组复制到新数组，然后用新数组替换旧数组。

如果 array 为 null，此方法将新建具有指定大小的数组。

如果 newSize 大于旧数组的 Length，则分配一个新数组，并将所有元素从旧数组复制到新数组。 如果 newSize 小于旧数组的 Length，则分配一个新数组，并将元素从旧数组复制到新数组直到新数组被填满为止；旧数组中的剩余元素将被忽略。 如果 newSize 与旧数组的 Length 相等，则此方法不执行任何操作。

此方法的运算复杂度为 O(n)，其中 n 是 newSize。

System.Array.Resize 方法例子

下面的示例显示调整大小操作如何影响数组。

using System;

public class SamplesArray  
{
    public static void Main()  {

        // Create and initialize a new string array.
        String[] myArr = {"The", "quick", "brown", "fox", "jumps", 
            "over", "the", "lazy", "dog"};

        // Display the values of the array.
        Console.WriteLine( 
            "The string array initially contains the following values:");
        PrintIndexAndValues(myArr);

        // Resize the array to a bigger size (five elements larger).
        Array.Resize(ref myArr, myArr.Length + 5);

        // Display the values of the array.
        Console.WriteLine("After resizing to a larger size, ");
        Console.WriteLine("the string array contains the following values:");
        PrintIndexAndValues(myArr);

        // Resize the array to a smaller size (four elements).
        Array.Resize(ref myArr, 4);

        // Display the values of the array.
        Console.WriteLine("After resizing to a smaller size, ");
        Console.WriteLine("the string array contains the following values:");
        PrintIndexAndValues(myArr);
    }

    public static void PrintIndexAndValues(String[] myArr)  {
        for(int i = 0; i < myArr.Length; i++)  
        {
            Console.WriteLine("   [{0}] : {1}", i, myArr[i]);
        }
        Console.WriteLine();
    }
}

/* 
This code produces the following output.

The string array initially contains the following values:
   [0] : The
   [1] : quick
   [2] : brown
   [3] : fox
   [4] : jumps
   [5] : over
   [6] : the
   [7] : lazy
   [8] : dog

After resizing to a larger size, 
the string array contains the following values:
   [0] : The
   [1] : quick
   [2] : brown
   [3] : fox
   [4] : jumps
   [5] : over
   [6] : the
   [7] : lazy
   [8] : dog
   [9] :
   [10] :
   [11] :
   [12] :
   [13] :

After resizing to a smaller size, 
the string array contains the following values:
   [0] : The
   [1] : quick
   [2] : brown
   [3] : fox

*/

异常

异常 异常描述
ArgumentOutOfRangeException newSize 小于零。

命名空间

namespace: System

程序集: mscorlib（在 mscorlib.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1 受以下版本支持：

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

相关资源

Array 类
System 命名空间
MSDN